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(54) Results-oriented help displays for computer software programs 



(57) Special bit-mapped images, or buttons, are 
programmed to display in a primary topic window of an 
on-line help system when a result or warning may be 
helpful to the user. The user can choose whether or not 
to click a pointing device, such as a mouse, on a bit- 
mapped image. Clicking the pointing device on the bit- 
mapped image will pull up the expected result or warn- 



ing in either a secondary topic window or pop-up, either 
of which can be closed when the information has been 
reviewed. Such an organization of help information in 
multiple windows provides users with access to infor- 
mation that may be useful and even essential, without 
cluttering the primary topic window and decreasing user 
productivity. 
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PC-CacheFS Help 



File Edit Bookmark Options Help 

Find |HeipTopics| Back | Print || Options || << 



Glossary 



1 In the PC-CacheFS main window, click the Cache menu. 

2 Click Configuration. 

3 In the PC-CacheFS Configuration dialog box, click Let me specify my own cache settings. 

4 Click the Advanced button. 

5 In the Advanced dialog box, click Configure drives independently , than click the tab shewing the drive lette r of the 
drive for which you want to change settings. 
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Results 

The Advanced dialog box is set up to receive your selections of advanced settings for a particular drive. The fields 
in the Global tab are grayed out and inactive. The fields in the tabs of the drive letters are active to enable you to 
change advanced settings tor the drives of your choice. 



Enabling Directory Caching for one Drive 
Enabling Di rectory Caching Glo bally 
Charging the Read Size 
Cha nging , the Write Size 



Fig. 3 
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Description 

FIELD OF THE INVENTION 

This invention relates to graphical user interfaces 
(GUIs) for computing systems and to methods and tech- 
niques for providing help to the user during the running 
of application programs on a computing system. 

DESCRIPTION OF RELATED ART 

As graphical user interface (GUI) operating system 
environments have come to dominate the computer in- 
dustry, on-line help documentation (hereinafter referred 
to as an On-line Help System) is generally implemented 
in a GUI environment. Many GUI environments, such as 
Microsoft® Windows™ ver. 3 X, Microsoft Windows 95, 
Windows NT®, IBM Corporation's OS/2®, and Geow- 
orks® have been developed. As this is written, Microsoft 
Windows ver. 3.X is far and away the most used inter- 
face, having been bundled within nearly every personal 
computer sold within the past five years. However, Win- 
dows 95 is expected to become the GUI of choice for 
both home and business applications and may eventu- 
ally eclipse ver. 3.X as the most used GUI interface. 
GUIs generally have the following common characteris- 
tics: 

• A graphical pointer or cursor is present within each 
window displayed; 

• The pointer or cursor can be moved to any location 
within the window by moving a pointing device, such 
as a mouse; 

• Movement of the pointer or cursor tracks movement 
of the pointing device; 

• Commands to the program may be input through 
either a keyboard or through the pointing device; 

• Certain bit-mapped images and/or text items are 
assigned "hot" status, which means that such an im- 
age or item may be activated in order to send a com- 
mand to the program; 

• Input via the pointing device is accomplished by 
moving the pointer or cursor so that it is positioned 
over a "hot" bit-mapped image or text item, and 
pressing a particular button on the pointing device. 
Such input is known as clicking. 

An On-line Help System operating in a Windows en- 
vironment incorporates a "help engine," which is a soft- 
ware program module designed to understand requests 
for action from the On-line Help System. The Microsoft 
Windows 95 operating system incorporates a help en- 
gine program module called "WinHelp 4." 

Requests for action from the On-line Help System 
are input by activating "hot" bit-mapped images or text 
items (hereinafter collectively referred to as activation 
entities) to which help engine program links are as- 
signed. When a user clicks on an activation entity which 



is programmed to request such action, the On-line Help 
System calls the help engine, which responds by dis- 
playing a new window. 

Two types of video monitor display formats, which 
5 are called "windows" are available within the Microsoft 
Windows GUI On-line Help System: topic windows and 
pop-ups. Both types of windows may be utilized by de- 
velopers of an On-line Help System written for a Micro- 
soft Windows GUI environment. 
10 A topic window is a standard, fully-functional win- 
dow which has a title bar, and which can be closed by 
clicking a "close window" icon located within the title bar 
once the user has reviewed the desired information. 
A pop-up ; on the other hand ; is an on-line graphical 
15 box that temporarily displays information when a user 
clicks on an activation entity. Pop-ups, which are some- 
times called pop-up boxes or pop-up windows, generally 
displace only a portion of the topic window. A pop-up 
can generally be closed simply by clicking anywhere 
20 outside the pop-up box in the undisplaced portion of the 
topic window, thus fully restoring the latter. 

Designers of the On-line Help System rely on the 
use of pop-ups to keep a secondary level of information 
which a user may or may not want to access out of the 
25 main help windows of the On-line Help System. By mov- 
ing this information to an accessible and less visible lay- 
er of the On-line Help System, designers of such sys- 
tems can: 

30 • Reduce the amount of text displayed in a topic win- 
dow; 

• Cater to a wider variety of users: those who want to 
access the secondary information, as well as those 
who do not want to access the secondary informa- 

35 tion; 

• Replace a formidable-looking, lengthy tract of infor- 
mation that users might choose not to read in the 
main help window with an attractive, easily-acces- 
sible button that a user would want to click. The 

40 same information that looks oppressive in a main 
window appears convenient and pleasant in a pop- 
up. 

The user of a computer program undergoing exe- 
45 cution by a computing system is frequently required to 
provide an input in response to a displayed instruction 
for each step of a series of procedural steps. If written 
documentation provided with the program lacks a de- 
scription or graphical representation of the result of each 
50 step as it is completed, the user can only hope that each 
input is correct and that the program is operating as de- 
signed. Classic examples of multi-step procedures are 
found in software installation programs. As the installa- 
tion process is likely the user's first encounter with the 
55 software, confusion, uncertainty, frustration, and even 
anger may result if the process does not proceed 
smoothly. Frustration is typically heightened if the instal- 
lation program "crashes," or the resulting installed soft- 
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ware fails to function as designed by its developers. If 
users don't know what to expect as the result of a par- 
ticu lar installation step, they may be apprehensive about 
proceeding with subsequent steps. 

To mitigate the difficulties that users often face dur- 
ing the operation of their programs, instructional docu- 
mentation may be provided with a software product in 
the form of hard-copy manuals and on-line help. Hard 
copy documentation may provide either a textual de- 
scription of the result of each step of a procedure or an 
illustration (e.g., a screen-capture) of the graphical user 
interface which shows the intended result of the step. 
However, with respect to an On-line Help System, -doc- 
umentation which provides result descriptions for pro- 
cedures and steps of procedures lengthens the content 
displayed in a topic window, and takes up too much of 
the visual area perceived by a user. Usability studies 
have shown that users do not like to scroll through more 
than three screens of information. Screens beyond 
three are likely to be ignored. Topic windows, length- 
ened by procedural results, compel users to scroll 
through either a long screen or several screens of infor- 
mation that some users may consider irrelevant. By the 
time a user has reviewed the extensive help information, 
closed the help window and returned to the main screen, 
the user may have forgotten the gist of the procedure. 
Users face a similar problem when software provides 
lengthy warnings associated with a step or procedure. 

Although result and warning displays may provide 
useful information within the On-line Help System-par- 
ticularly if the hard copy documentation has been lost 
or misplaced-every user may not want, or need, to ac- 
cess them. Users who already have experience with the 
program may not require the additional information. Oth- 
er users may simply not want to be bothered with non- 
essential information. 

SUMMARY OF THE INVENTION 

In accordance with this invention, the above prob- 
lem and concerns have been solved by embedding ac- 
tivation entities, such as bit-mapped images of result or 
warning buttons, in a topic window containing on-line 
textual procedures of an On-line Help System when the 
display of a result or warning may be helpful to a user. 

If the user is interested in viewing the resu It or warn- 
ing, the user may click on the activation entity with a 
pointing device, such as mouse. Clicking the pointing 
device on the activation entity causes the desired infor- 
mation to display in either another topic window or a 
pop-up. Once the information has been reviewed by the 
user, the activated window can be closed to restore the 
primary help window. 

The foregoing and other features, utilities and ad- 
vantages of the invention will be apparent from the fol- 
lowing more particular description of a preferred embod- 
iment of the invention as illustrated in the accompanying 
object code listing and in the drawings. 



BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block diagram of a representational 
computing system and operating environment for 

s performing the computer implemented steps of the 

method in accordance with the invention; 
Figure 2 is a monochrome laser printout of a topic 
window within an On-line Help System having an 
activation entity in the form a bit-mapped "results" 

10 button, said button not yet having been clicked on 
with a pointing device; 

Figure 3 is a monochrome laser printout of the topic 
window of Figure 2 after the "results" button has 
been clicked on with a pointing device, and a pop- 
's up has been displayed; 

Figure 4 is a monochrome laser printout of a topic 
window within an On-line Help System having an 
activation entity in the form of a "warning" button, 
said button not yet having been clicked on with a 
20 pointing device; and 

Figure 5 is a monochrome laser printout of the topic 
window of Figure 4 after the "warning" button has 
been clicked on with a pointing device, and a pop- 
up has been displayed. 

25 

DETAILED DESCRIPTION OF PREFERRED 
EMBODIMENTS 

The embodiments of the invention described herein 

30 may be implemented as logical operations in a distrib- 
uted processing system having client and server com- 
puting systems. The logical operations of the present 
invention are implemented (1) as a sequence of com- 
puter implemented steps running on the computing sys- 

35 tern and (2) as interconnected machine modules within 
the computing system. The implementation is a matter 
of choice that is dependent on the performance require- 
ments of the computing system implementing the inven- 
tion. Accordingly, the logical operations making up the 

40 embodiments of the invention described herein are re- 
ferred to variously as operations, steps or modules. 

The environment in which the present invention is 
used encompasses the general distributed computing 
system, wherein general purpose computers, worksta- 

45 tions or personal computers are connected via commu- 
nication links of various types, in a client-server arrange- 
ment, wherein programs and data, many in the form of 
objects : are made available by various members of the 
system for execution and access by other members of 

50 the system. Some of the elements of a general purpose 
workstation computer are shown in Fig. 1, wherein a 
processor 1 is shown, having an input/output ("I/O") sec- 
tion 2, a central processing unit ("CPU") 3 and a memory 
section 4. The I/O section 2 may be connected to a key- 

55 board 5, a display unit 6, a disk storage unit 9, a CDROM 
drive or unit 7 or a computer network 11 such as a wide 
area network ("WAN"), local area network ("LAN") or 
other network connection such as the Internet. The 
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CDROM unit 7 can read a CDROM or CDROM medium 
8 which typically contains programs 10 and data. The 
computer program products containing mechanisms to 
effectuate the apparatus and methods of the present in- 
vention may reside in the memory section 4, or on a disk 
storage unit 9 or on the CDROM 8 or network 1 1 of such 
a system. Examples of such systems include SPARC® 
systems offered by Sun Microsystems, Inc., personal 
computers offered by IBM Corporation and by other 
manufacturers of IBM-compatible personal computers, 
and systems running the UNIX® operating system. 

As Microsoft Windows-based applications form a 
significant portion of the personal computer industry, 
this invention will be described in the context of an On- 
line Help System as it exists within a Microsoft Windows 
environment. 

In order to create a results-oriented On-line Help 
System, certain activation entities are programmed to 
appear within a topic window of the On-line Help Sys- 
tem. In a preferred embodiment of the invention , such 
an entity is a bit-mapped image which may be labeled 
"RESULT" if the result of a procedural step is to be dis- 
played or "WARNING" or merely "!" if a warning for a 
procedural step is to be displayed. In a Windows envi- 
ronment, specially designed bit-mapped activation en- 
tities are saved as files having a .BMP extension. How- 
ever, p re-formatted buttons available to the Windows 
application developer or "hot text" may also be used as 
the activation entity. 

The user can choose whether or not to click a point- 
ing device on the activation entity. Clicking the activation 
entity with the pointing device causes the On-line Help 
System to call the help engine which, in turn, displays 
the desired information in either a topic window or a pop- 
up in accordance with the file format. In a preferred em- 
bodiment of the invention, the On-line Help System is 
programmed to display a pop-up when the user clicks 
on the result or warning activation entity with a pointing 
device. 

Figure 2 is a printout of a primary topic window for 
a Windows On-line Help System written for a program 
titled PC-CacheFS by Sun Microsystems, Inc. This top- 
ic window istitled "Enabling Directory Caching." A small- 
er-sized, but fully functional secondary topic window, 
having a different appearance but the same functionality 
as the primary topic window displays as an overlay of 
the right side of the primary topic window. This second- 
ary topic window, titled "Changing Advanced Settings 
for One Drive," contains an activation entity in the form 
of a "result" button, which may be clicked with a pointing 
device. 

Figure 3 depicts the result of clicking the result but- 
ton of Figure 2. A pop-up displays, overlying portions of 
both the primary topic window and secondary topic win- 
dow. The pop-up, titled "Result" contains a written de- 
scription of the result expected when drives are config- 
ured independently. 

Figure 4 depicts the printout of another primary top- 



ic window of the PC-CacheFS On-line Help Systems. 
The title of this primary topic window is "Installing-PC- 
CacheFS." A secondary, fully-functional topic window ti- 
tled "Express Installation in Windows 3.1 and Windows 

5 for Workgroups 3.11" overlies the right side of the pri- 
mary topic window "Installing PC-CacheFS." In this sec- 
ondary window is a warning button in the shape of a tri- 
angle displaying the exclamation mark character (!). 
Like the previous result button, this warning button may 

10 be clicked with a pointing device. 

Figure 5 depicts the result of clicking the warning 
button of Figure 3. A pop-up displays, overlying portions 
of both the primary topic window and the secondary top- 
ic window of Figure 4. The pop-up, which is titled "Warn- 

15 jng!" contains a written warning that identifies the des- 
tination directory of the established cache file as the root 
directory, and also indicates the potential consequences 
of removing the cache file from the root directory or mod- 
ifying that file. 

20 Results-oriented help information as shown and de- 
scribed above ; provides useful information to the user 
who may or may not need such information, without clut- 
tering the display screens and decreasing productivity 
for users who do not need the information. 

25 While the invention has been particularly shown 
and described with reference to a preferred embodiment 
thereof, it will be understood by those skilled in the art 
that various changes in the form and details may be 
made therein without departing from the spirit and scope 

30 of the invention. For example, topic windows may be 
used in place of pop-ups to provide results and warnings 
to the user. In addition, the invention may be easily 
adapted for use in other GUI environments. 



1. A method encoded in the form of binary program 
instructions for making available to a user, in a 

40 graphical user interface environment, information 
related to an expected result of a procedural step 
prior to executing the step on a computing system, 
said method comprising the steps of: 

45 (a) displaying a first help window having an ac- 

tivation entity displayed thereon; 

(b) displaying a second help window which ap- 
pears and at least partially displaces the first 
help window in response to the user clicking on 

50 said activation entity with a pointing device, 

said second help window containing informa- 
tion regarding the expected result; and 

(c) clearing the second help window and restor- 
ing the first help window in response to user 

55 provided input through said pointing device. 

2. The method of Claim 1 , wherein the information re- 
lated to the expected result is provided as a screen 
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capture of an actual non-help-related program win- 
dow display as it would appear following execution 
of the procedural step. 

3. The method of Claim 1 , wherein the information re- 
lated to the expected result is provided as a textual 
description. 

4. The method of Claim 1 , wherein said activation en- 
tity is a bit-mapped image. 

5. The method of Claim 4, wherein said bit-mapped 
image includes a label titled "RESULT". 

6. The method of Claim 1 , wherein the information re- 
lated to the expected result is a warning. 

7. The method of Claim 1 , wherein both first and sec- 
ond windows are topic windows. 

8. The method of Claim 1, wherein said first window 
is a topic window and said second window is a pop- 
up. 

9. A computer implemented process for making avail- 
able to a user, in a graphical user interface environ- 
ment, information related to an expected result of a 
procedural step prior to executing the step on a 
computing system, said method comprising the 
steps of: 

(a) displaying a first help window having an ac- 
tivation entity displayed thereon; 

(b) displaying a second help window which ap- 
pears and at least partially displaces the first 
help window in response to the user clicking on 
said activation entity with a pointing device, 
said second help window containing informa- 
tion regarding the expected result; and 

(c) clearing the second help window and restor- 
ing the first help window in response to user 
provided input through said pointing device. 

10. The process of Claim 9, wherein the information re- 
lated to the expected result is provided as a screen 
capture of an actual non-help-related program win- 
dow display as it would appear following execution 
of the procedural step. 

11. The process of Claim 9, wherein the information re- 
lated to the expected result is provided as a textual 
description. 

12. The process of Claim 9, wherein said activation en- 
tity is a bit-mapped image. 

13. The process of Claim 12, wherein said bit-mapped 
image includes a label titled "RESULT". 



14. The process of Claim 9, wherein the information re- 
lated to the expected result is a warning. 

15. The process of Claim 9, wherein both first and sec- 
s ond windows are topic windows. 

16. The process of Claim 9, wherein said first window 
is a topic window and said second window is a pop- 
up. 

10 

17. A computer program product comprising: a compu- 
ter-usable medium having computer-readable code 
embodied therein for making available to a user in 
a graphical user interface environment information 

15 related to an expected result of a procedural step 
prior to executing the step on a computing system, 
the computer program product further comprising: 
computer-readable program code devices config- 
ured to cause a computer to effect displaying a first 

20 help window having an activation entity displayed 
thereon; computer-readable program code devices 
configured to cause a computer to effect displaying 
a second help window which appears and at least 
partially displaces the first help screen in response 

25 to the user clicking on said activation entity with a 
pointing device, said second help screen containing 
information regarding the expected result; and com- 
puter-readable program code devices configured to 
cause a computer to effect clearing the second help 

30 window and restoring the first help window in re- 
sponse to user provided input through said pointing 
device. 

18. The computer program product of Claim 17, where- 
as in said computer program product further compris- 
es computer-readable program code devices con- 
figured to cause a computer to effect providing the 
information related to the expected result as a 
graphic representation of an actual non-help-relat- 

40 ed program screen as such screen would appear 
following execution of the procedural step. 

19. The computer program product of Claim 17, where- 
in said computer program product further compris- 

45 es computer-readable program code devices con- 
figured to cause a computer to effect providing the 
information related to the expected result as a tex- 
tual description. 

50 20. The computer program product of Claim 1 7, where- 
in said computer program product further compris- 
es computer-readable program code devices con- 
figured to cause a computer to effect representation 
of the activation entity as a bitmapped image. 

55 

21 . The computer program product of Claim 1 7, where- 
in said computer program product further compris- 
es computer-readable program code devices con- 
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figured to cause a computer to effect a warning as 
the information regarding the expected result. 
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